home *** CD-ROM | disk | FTP | other *** search
/ SGI Networker 4.2.9 / Networker 4.2.9 for IRIX 6.2, 6.3 and 6.4.img / relnotes / networker / ch4.z / ch4
Text File  |  1997-07-08  |  14KB  |  397 lines
  1.  
  2.  
  3.  
  4.                                   - 1 -
  5.  
  6.  
  7.  
  8.        4.  _B_u_g__F_i_x_e_s
  9.  
  10.        Note:  This chapter covers some of the most important issues
  11.               that have been resolved since the 4.2.5 and 4.1.3
  12.               releases.
  13.  
  14.  
  15.  
  16.  
  17.        4.1  _B_u_g_s__f_i_x_e_d__b_y__L_e_g_a_t_o
  18.  
  19.        A number of minor bugs were fixed in 4.2.9. With Power
  20.        Edition technology, IRIX NetWorker is able to offer greatly
  21.        increased performance when backing up the IRIX NetWorker
  22.        server to local tape drives.
  23.  
  24.        In addition, there were many bug fixes and performance
  25.        improvements with the 4.1.3 version, including many from
  26.        Legato which SGI has integrated into the IRIX NetWorker
  27.        product. Some examples of these are as follows.
  28.  
  29.           +o Improved index logic, resulting in greater reliability
  30.             and faster performance.
  31.  
  32.           +o NetWorker CPU utilization has been reduced and
  33.             throughput has been improved for both server-based and
  34.             network-based backups.
  35.  
  36.           +o Variable block sizes for high-speed tape devices.
  37.             (Support for high-performance tape devices is optional,
  38.             and is enabled by the PerformancePak license option.)
  39.  
  40.  
  41.        4.2  _B_u_g_s__f_i_x_e_d__b_y__S_G_I__i_n__I_R_I_X__N_e_t_W_o_r_k_e_r__4_._2_._9
  42.  
  43.        _B_u_g #_4_8_0_5_5_0
  44.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Sparse files ending in holes caused save process
  45.        to hang.
  46.  
  47.        Very rarely, a sparse file may end with a non-data area, or
  48.        a hole. In this unusual case, the client saving process of
  49.        IRIX NetWorker 4.2.5 could hang.  This problem has now been
  50.        resolved, and these files can be backed up and restored
  51.        correctly.
  52.  
  53.  
  54.        _B_u_g #_4_6_8_2_2_7
  55.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Filesystem <= 8 KB blocksize restriction.
  56.  
  57.        A restriction was introduced with IRIX NetWorker 4.2.5 that
  58.        the filesystem on which /nsr resides could not have a
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.                                   - 2 -
  71.  
  72.  
  73.  
  74.        blocksize greater than 8 KB. Since the default blocksize for
  75.        XFS filesystems is 4 KB, this issue did not affect many
  76.        sites. This restriction is now removed, and any filesystem
  77.        block size supported by the underlying XFS filesystem can be
  78.        used for the the /nsr filesystem.
  79.  
  80.  
  81.  
  82.        4.3  _B_u_g_s__f_i_x_e_d__b_y__S_G_I__i_n__I_R_I_X__N_e_t_W_o_r_k_e_r__4_._2_._5
  83.  
  84.        _B_u_g #_3_5_7_6_2_7
  85.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Inventory problem on Odetics 2640-3 (264 slots).
  86.  
  87.        Inventory operations did not work on an Odetics 2640-3 unit
  88.        (264 slots) in the slot range 256-264 when the unit was
  89.        being run in a non-barcode mode.  This was a problem with a
  90.        calculated buffer size being calculated incorrectly, and
  91.        thus not being quite large enough for use with large
  92.        jukeboxes.
  93.  
  94.  
  95.        _B_u_g #_3_8_8_6_4_6 _a_n_d #_3_9_1_0_3_8
  96.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Core dump seen only on R5000 CPU.
  97.  
  98.        A library routine failed on the R5000 CPU, causing NetWorker
  99.        to core dump.  The library routine was modified to avoid the
  100.        problem. This problem affected only the IRIX NetWorker
  101.        server running on the R5000 CPU.
  102.  
  103.  
  104.        _B_u_g #_3_9_9_0_4_5
  105.        SSSSuuuummmmmmmmaaaarrrryyyy::::  NetWorker does not skip nfs2 filesystems
  106.  
  107.        NetWorker did not know that it should treat filesystems with
  108.        type nnnnffffssss2222 in the same manner as it treated filesystems with
  109.        the type nnnnffffssss.  Solved by adding code to recognize the nnnnffffssss2222
  110.        filesystem type as functionally identical to the nnnnffffssss type.
  111.  
  112.  
  113.        _B_u_g #_4_1_0_8_5_3
  114.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Output file on disk can now be larger than 2 GB.
  115.  
  116.        IRIX NetWorker had limited the size of an output disk file
  117.        to 2 GB.  This limit has now been removed. (Although the
  118.        usual situation is for IRIX NetWorker's output devices to be
  119.        tape drives, it is possible to configure a disk file as an
  120.        IRIX NetWorker output device.)
  121.  
  122.  
  123.        (_N_o _b_u_g _n_u_m_b_e_r)
  124.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Added support for STK 9710 and IBM 3590 ACF
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                   - 3 -
  137.  
  138.  
  139.  
  140.        jukeboxes.
  141.  
  142.        The IBM 3590 ACF is now supported by NetWorker. However,
  143.        NetWorker 4.2.x can use the IBM 3590 ACF only if the unit is
  144.        configured properly. Follow these steps to configure the
  145.        unit, and to bring it on-line.
  146.  
  147.           +o With power off to all machines, cable the unit
  148.             appropriately to the server running IRIX Networker.
  149.  
  150.           +o Power-on the unit, and wait for its power-on
  151.             diagnostics to complete.
  152.  
  153.           +o At the conclusion of the power-on diagnostics, verify
  154.             that the port on the rear of the unit, to which you
  155.             attached the unit's cable, is listed on the front panel
  156.             as _o_n_l_i_n_e.  If the correct port is not listed as
  157.             _o_n_l_i_n_e, then use the unit's front panel _U_p and _D_o_w_n
  158.             arrow buttons to select _S_e_r_v_i_c_e_s..., and then press the
  159.             _E_n_t_e_r button. Use the menu that appears to select the
  160.             approprate port configuration. Finally, using the _E_n_t_e_r
  161.             button, select _C_a_n_c_e_l until you return to the top-level
  162.             menu.
  163.  
  164.           +o Using the unit's front panel _U_p and _D_o_w_n arrow buttons,
  165.             move the cursor to _S_e_t _A_C_F _m_o_d_e ...  and press the
  166.             _E_n_t_e_r button
  167.  
  168.           +o Press the _U_p and/or _D_o_w_n buttons until _R_a_n_d_o_m is
  169.             highlighted, and then press the _E_n_t_e_r button.
  170.  
  171.        At this point, the unit's front panel should indicate _o_n_l_i_n_e
  172.        status for the port to which you have attached the computer
  173.        cable, and that the unit is in _R_a_n_d_o_m mode. This
  174.        configuration is required for proper operation with IRIX
  175.        NetWorker 4.2.x.
  176.  
  177.  
  178.  
  179.        _B_u_g_s #_3_1_9_6_0_5
  180.        SSSSuuuummmmmmmmaaaarrrryyyy::::  Added a "pause" capability for group management.
  181.  
  182.        This feature allows groups to be managed more flexibly.
  183.        Proper use of this feature may mitigate the problems
  184.        reported by the referenced incident.
  185.  
  186.        IRIX NetWorker save groups now support a _p_a_u_s_e capability.
  187.        This allows system administrators to exercise more control
  188.        over the execution order of client saves. A typical use
  189.        would be to temporarily suspend activation of new client
  190.        saves from one save group, in order to avoid blocking client
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                                   - 4 -
  203.  
  204.  
  205.  
  206.        saves belonging to other groups.
  207.  
  208.        The pause capability is controlled by a _p_a_u_s_e_l_i_s_t file,
  209.        which is a text file located in /_n_s_r/_t_m_p.  The file must be
  210.        named _p_a_u_s_e_l_i_s_t; the complete path must be
  211.        /_n_s_r/_t_m_p/_p_a_u_s_e_l_i_s_t.
  212.  
  213.        IRIX NetWorker uses the contents of the pauselist file to
  214.        determine when client saves from a save group should be
  215.        initiated. If a group is paused, then no new client saves
  216.        from that group will be started. Use the following rules to
  217.        construct the pauselist file:
  218.  
  219.           +o If the pauselist is nonexistent or empty, then no
  220.             groups are paused.
  221.  
  222.           +o If the pauselist is non-empty, it is expected to
  223.             contain lines of text.
  224.  
  225.           +o The first line of the pauselist must be its version
  226.             number, as follows.  Currently, only version 1 is
  227.             supported.
  228.  
  229.                  1111
  230.  
  231.           +o All following lines are interpreted as group names, one
  232.             per line.
  233.  
  234.           +o A group known to IRIX NetWorker is paused if its name
  235.             is in the pauselist.
  236.  
  237.        How (or whether) the pauselist is actually used is
  238.        determined by the system administrator. The pause capability
  239.        can be completely ignored, because without a pauselist file,
  240.        no groups will ever be paused. This represents no change
  241.        from the previous behavior of IRIX NetWorker 4.1.3.
  242.  
  243.        A typical use of this pause capability would be to control
  244.        access to tape drives, when multiple save groups are
  245.        competing for control. For example, suppose there is a save
  246.        group named "Bldg A Workstations", starting at 7:00 pm, and
  247.        has many client saves to initiate. There is another save
  248.        group, named "Master Databases", which is scheduled to start
  249.        at 10:00 pm. However, by 10:00 pm, only about half of the
  250.        "Bldg A Workstations" save group is complete; the remaining
  251.        client saves that are part of "Bldg A Workstations" would
  252.        compete with the "Master Databases" save group client saves.
  253.        The pause capability allows the system administrator to
  254.        temporarily stop processing new client saves from one save
  255.        group, to allow another save group to initiate its client
  256.        saves.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                                   - 5 -
  269.  
  270.  
  271.  
  272.        In the above example, to pause the "Bldg A Workstations"
  273.        save group, and therefore prevent it from monopolizing
  274.        NetWorker's attention, the system administrator would create
  275.        a pauselist file at about 10:00 pm. Line 1 of the pauselist
  276.        must be the version number (currently 1). Line 2 is the name
  277.        of the save group to be paused. (Lines 3 and following could
  278.        be names of additional save groups to be paused.) In this
  279.        example, the pauselist at /_n_s_r/_t_m_p/_p_a_u_s_e_l_i_s_t would contain:
  280.  
  281.  
  282.             1111
  283.             BBBBllllddddgggg AAAA WWWWoooorrrrkkkkssssttttaaaattttiiiioooonnnnssss
  284.  
  285.        Continuing with the above example, the "Bldg A Workstations"
  286.        group is now paused, and no further client saves will be
  287.        initiated from that group. The "Master Databases" save group
  288.        will be able to initiate its client saves at this point.
  289.        Once the system administrator has verified that the client
  290.        saves from the "Master Databases" save group have been
  291.        successfully initiated, perhaps at about 10:10 pm, the
  292.        pauselist file can be deleted to allow the remaining "Bldg A
  293.        Workstations" client saves to be initiated.
  294.  
  295.        If desired, this entire procedure can be automated using
  296.        cron. The system administrator should determine when certain
  297.        save groups should be paused and unpaused. Using cron,
  298.        create a pauselist at these times, with specific save groups
  299.        mentioned. After an interval, which the system administrator
  300.        has determined to be a sufficient length of time for other
  301.        (unpaused) client saves to be initiated, then another
  302.        command can be initiated using cron which would delete the
  303.        pauselist (or change its contents).
  304.  
  305.        A helpful technique might be to preconfigure several
  306.        different copies of the pauselist, with differing contents,
  307.        under different names. When the system administrator
  308.        determines it is time to change the pause configuration,
  309.        then a selected preconfigured file is renamed to be
  310.        /_n_s_r/_t_m_p/_p_a_u_s_e_l_i_s_t, and it will be in effect.
  311.  
  312.        _C_a_v_e_a_t_s
  313.  
  314.        When a save group becomes paused, it means that no new
  315.        client saves from that group will be initiated. But client
  316.        saves that were initiated before the group was paused will
  317.        continue to run, even when the group becomes paused.
  318.  
  319.        Since groups are determined to be paused by comparing them
  320.        with the group names listed in the pauselist file, it is
  321.        important that groups have unique names. Also, the names
  322.        specified in the pauselist file are case sensitive; care
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                                   - 6 -
  335.  
  336.  
  337.  
  338.        must be taken that the capitalization in the pauselist
  339.        exactly matches the save group name as reported in the _G_r_o_u_p
  340.        _C_o_n_t_r_o_l window.
  341.  
  342.        Currently, this pause capability is not integrated into the
  343.        graphic user interface of _n_w_a_d_m_i_n.  Therefore, the _G_r_o_u_p
  344.        _C_o_n_t_r_o_l window cannot be used to pause or unpause a group.
  345.        Nor does the status display in that window indicate that a
  346.        group is paused. However, the message panel of _n_w_a_d_m_i_n's
  347.        graphic user interface displays messages approximately every
  348.        15 minutes when an otherwise runnable save group is paused.
  349.  
  350.        The _S_t_a_r_t, _R_e_s_t_a_r_t, or _S_t_o_p buttons in the _G_r_o_u_p _C_o_n_t_r_o_l
  351.        window can be selected, even for paused groups. If the
  352.        selected group is paused when one of these action buttons is
  353.        selected, the action chosen will take place, but not until
  354.        the group becomes unpaused.
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.